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ABSTRACT 


Fast and efficient mathematical programming routines 
have been developed for network flow problems, but due to 
their complexity the average manager or lay analyst does not 
possess the mathematical or programming background required 
to construct the models or use the solution technology 
available. This problem is solved here by the development 
of an interactive network generating system designed to 
create, update, and solve a single-commodity network with 
only a minimal knowledge of network structure and only a 
rudimentary mastery of computer terminal use. This is 
accomplished through the interactive use of a set of FORTRAN 
programs which lead the user, step-by-step, through the con- 
struction of the network by a series of queries, and which 

inks with GNET, a machine independent FORTRAN program for 


the solution of capacitated network flow problems. 
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Over the past two decades, research in optimization of 
network flow models has resulted in the development of fast 
and efficient mathematical programming routines for the 
solution of this class of problems. Coupling this with the 
ready availability of hiqh speed computers, network problems 
long viewed as impracticable are now routinely used by 
Management. 

Due to the complexity of these algorithms and the intri- 
cacy of the models required to use them, the average nanager 
or lay analyst frequently does not possess the mathematical 
Or programming background required to construct the models 
or use the solution technology available. ee fochnleally 
trained support personnel are required to construct the 
models, implement the appropriate routines, and make modifi- 
cations. As a result, the decision maker or individual for 
whom the system was designed is insulated from it. This 
provides the major impetus for this thesis --- to create an 
interactive general network model-building and optimization 
System that can be used by an individual who has only a 
basic knowledge of network structure and a general under- 


standing of computer terminal use. 
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Currently, industry is using network model-building and 
Optimization systems as managemant Support systems. drone 
example, Hunt-Wesson Foods uses a multicommodity distribu- 
tion planning system based on a multicommodity network model 
fRef. 1] and has demonstrated effective application of the 
system [Ref. 2}. But as 1S common with all the models of 
this type, most of the interface facilities are used by 
technical support personnel rather than the managers then- 
selves. Managers must make their needs known to technically 
trained intermediaries who translate these needs into speci- 
fications for computer runs, make the runs, and Reese 
interpreting the results. This can lead to delays and read- 
ily lends itself to possible nisinterpretation by support 
personnel of the true intentions of the managers. 

A simple-to-use, interactive system would permit a man- 
ager to converse on a one-to-one basis with the model and 
provide an optimization process allowing for virtually 
immediate response to complicated network flow problems. 

The mode] developed here provides such capability for single 
commodity capacitated network flow problems, and can be 
expanded to handle more complex problems by the implementa- 


tion of the enhancements listed in chapter II. 
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The single commodity capacitated flow model and its spe- 
cializations constructed by the system are mininum cost net- 
work flow problems. The goal is to determine how (or at 
what rate) a good should flow through the arcs of a network 
to minimize shipment costs. The network is a directed graph 
defined by a set of m nodes, N, and a set of n arcs, A, with 
ordered pairs of nodes (tail,head) as elements indexed by k. 
Por each arc there 1S a shipping cost per unit flow (or 
capacity), Ch. Each node is either a supply node where 
units of goods enter the network, a demand node where units 
leave, or transhipment node. The problem is to minimize 
total cost with flows, x,, that satisfy the associated lower 
bounds and capacities and preserve the conservation of flow 


at each node: 


re) tes zy x ~ 3 x. = D 5; = lS 


k © A with tail i k © A with head i 


where b. = (supply if iis a supply node; -demand if iis a 
1. 


demand node; 0 otherwise) [Ref. 3]. 


eZ 


This interactive network model-building system was 
designed for the user who has only a minimal knowledge of 
networks. If the user can identify the fact that the prop- 
lem to be solved can be represented as a single commodity 
capacitated flow network and has a basic knowledge of con- 
puter terminal use, then with the aid of the User's Manual 
(Chapter III) he should be able to effectively use the sys- 
tem. The system leads the user through the construction of 
a network by a series of simple questions. The model may 
then be immediately (or repeatedly) solved with GNET, a 
machine-independent FORTRAN program for solution of capaci- 
tated network flow problems [Ref. 3]. 

The features of the system may be summarized as follows: 

1. The system is completly general for the class of 
problems at hand, allowing for a large number of diverse 
applications that include transport of goods, design of conm- 
munications and pipeline systems, assignment of people to 
eee, cCOUting of vehicles, bid evaluation, and production 
planning. For a comprehensive look at state-of-the-art net- 
work model applications see [Ref. 4]. 

2. The user may customize the system to the specific 


problem being solved by the interactive input of user 
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defined labels for each node, naming the commodity passing 
through the network, and specifying the units of flow and 
mmees Of cost per unit of flow, 

3. The system will create an entire network or allow 
for the modification of single elements of a previously con- 
structed network. 

4. The data-base requires minimal storage space. 

5. A series of checks are built into the system to pre- 
vent the construction of a mathematically inconsistent 
network. 

6. The user can execute commands by a single keystroxe 
on a terminal. 

7. %GNET one of the fastest and most efficient prograns 
currently available for solving capacitated transhipment 
problems, thus allowing for virtually immediate solution of 
most network problems constructed. 

8. The system is reasonably portable between different 
computer installations. 

9. The system is designed for ease of expansion and 


modification. 
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A. GENERAL 

The interactive network generating system consists of a 
driver program which co-ordinates the overall functioning of 
the system and eight subsystems which carry out the creation 
or modification of the network. 

1. Data Base 

The data base is structured in the same form as the 

data base for GNET {Ref. 3]. This structure minimizes stor- 
age but still allows for ease of manipulation. The arcs are 
sorted so that all arcs with the same head are stored in 
contiguous space. This permits the list of head nodes to be 
replaced by a node-length array whose jth element is the 
location of the first are with head j. Thus, the network is 
stored as three arc-length arrays: the tail nodes T( ), the 
costs C(), the minimum capacities MNCP( ), and the maxinua 
Capacities MXCP( ); also, three node-length arrays are used, 
the head node entries H() into T( ), supplies S({ ) (-S() 
denotes demand), and node labels L( ). Figures 1 and 2 


(Ref. 3] show the data arrays for the network described in 


Figures 6, 7, and 8. 
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Node 
1 


1 
2 
3 


4 


12 


13 


lt Head 
H 


1 


1 


16 


Ay 


lFirst arc i located at k 


Fue 


34 


56 


Label 


Los Angeles 
New York 
Chicago 


Omaha 


Satin Fare 6 iry 


Ace ah ca 
Seattle 
Denver 
Austin 
Minneapolis 
Washington 


Miami 


Bl (Gee 


2Negative supply denotes demand. 


Figure 1: 


Node Data Arrays 
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C220 


0500 


S430 


A345 


S340 


D516 


225 


M5174 


W252 


4500 
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Cost eo capect ty 
34 0 
ZS 0 
28 0 
45 5 
Dil 0 
24 0 
56 0 
19 0 
61 0 
99 0 
48 0 
oe 0 
26 0 
20 0 
14 10 
34 0 


LUKRRAKEEN denotes unlimited capacity 


FaeawEe: 2% 


Arc Data Arrays 
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lMaximum Capacity 
MXCP 
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10 


ZS 
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12 


24 
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2. Host Language 

The system has been developed in FORTRAN IV Extended 
(Ref. 5]. FORTRAN was chosen for the following reasons: 

a. FORTRAN is a general language available at most 
computer installations, so the system can be used with any 
contemporary hardware. Non-IBM systems may require some 
program modifications. 

b. Since FORTRAN is a high-level language, the 
development time has been low. 

c. The response time for each question is accepta- 
ble and there is little need for faster responses or 
enhanced efficiency. 

d. Extensions and changes for the system can be 


easily imoplemented. 


B. THE PROGRAM 
ieee 263. ver 
The driver program initializes the system and co- 
ordinates the interaction of all the subsystems [Fig. 3]. 
If a new file is being created, all counters are initialized 
at zero and all arrays are blank, allowing for the construc- 
tion of a new network. If an existing file is to be modi- 


fied or completed, the old file is read into the arrays and 


the counters are set at the appropriate values. 
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The overall co-ordination of the subsystems is 
maintained through the selection of the appropriate option 
from a menu for creating or updating the data file via user 
input. Once the action is completed, control is returned to 
the driver program and the user is prompted for the selec- 
tion of another option. The system has been designed to 
allow the user to return to the option list at any time dur- 
ing a terminal session by using a predefined character (ie. 
a Wmpity , 

2. subsystems 
a. Adding Nodes 

Adding a node i to the network is accomplished 
by first reading in the label to be assigned to the node. 
Prior to entering the label into the label array L{ ), it is 
checked against all existing labels to ensure that it has 
not previously been used. If the check is satisfactory then 
the label is stored in L({i) and the head node entry array 
element H(i) is created where H(i) = H({it+1) indicating that 
the predecessor arcs, aS of now, are not created. A supply 
is then stored in S$(i), and finally the predecessor arcs are 


created by calling the arc-creating subroutine. 


20 


a re BP =< 
>r>p ff * , | 





BS a os Oo 
ei a — — 7 
w : , ae — | 
Pe cll - —_ a iy o) : 
: | } 7 ; : 7 7 os 7 7 
- | | 7 
7 
<j 7 — 
a: 7 7 
- _ 
: 
- os 
7 
Zz 


PHesuises is also provided the capability of 
Creating a node i "like" a node gq. All data currently asso- 
Ciated with node g is copied for node i. The user can then 
modify the costs, add or delete arcs, etc. for node i by 
returning to the option list and selecting the appropriate 
options to effect the changes. 

be Creating Arcs 

An arc i,j can be created either in conjunction 
with the creation of a node or independently. If it is 
created in conjunction with a node, the head node index iis 
passed to the subroutine as the head node for the subsequent 
arc. If the are is being created independently, the head 
node label must be entered at the terminal and its index 
determined by a search of the label array. 

When a head or tail node label is entered during 
the arc creation routine, the label is checked against all 
other existing labels. If a match is found, the index for 
the node label is used in all subsequent actions concerning 
that node. If a match is not found, then a node is created 
and flagged by placing a dummy value as the supply for the 
node (ie. Sfi) = 2x169) to indicate that the node must be 


formally defined (as a source, sink, or pure transhipment 
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node by entering a supply or demand) subsequently using the 
mode creation option prior to completion of the network 
description. 

Once the head and tail node indices, i and j 
respectively, have been determined, the arc i,j is added to 
the network. The arc is linked to the head node 1 by set- 
mengeH{g) = H(q)+1 for all g 2 i. The tail node j is linked 
to the arc ky expanding the tail array T( ) and inserting 
the index j at the appropriate location, T(H(i)) = j. This 
procedure maintains the contiguous relationship of all arcs 
with same head node and allows for an orderiy expansion of 
the network. 

c. Deleting Nodes 

When deleting a node i all arcs incident to that 
node must be deleted as well. For this reason all incident 
arcs are identified, their location stored, and then listed 
at the terminal prior to the node being deleted. This 
allows the user to preview the total effect of the node 
deletion. 

The predecessor are indices are located directly 


from the head array (H({1) to H(i+1)-1). 


Ze 


a ie ne ee, a ee 
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Successor are indices are located by a Search of 
Mmemtail array for the set of ali k's such that T(k) = i. 
The head node index for one of the arcs k 1s identified by a 
_sequential search of the head array for a node index h such 
mec H{h) < k S$ H (h+1)-1. 

After all incident arcs have been listed at the 
terminal, the user is provided an opportunity to abort the 
Seeration. If it is decided to abort, no change to the data 
base occurs. If it is decided to continue, the arcs and 
nodes are deleted. The arrays T({ ), C(), MNCP({ ), and 
MXCP( ) are condensed to reflect the deletion of the arcs 
Mumcmmilarly H{ }, S{), and L{ ) are condensed to reflect 
the deletion of the node. The node indices in the array 
T( ) which are greater than the index of the node deleted 
must be decremented by one. The are indices in the head 
array must be decremented sequentially by the number of pre- 
decessor arcs to that node that were deleted plus the number 
of predecessor arcs that were deleted from all head nodes 
listed prior to the node baing decremented. Through these 
index manipulation procedures the network structure can be 


efficiently maintained in situ. 
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d. Deleting Arcs 
When deleting an arc i,j, the are is identified 
by the input of its head and tail node labels. ‘When multi- 
ple arcs i,j exist the user must salect the correct are fron 
the display of the respective are costs and capacities. 
Once the arc is uniquely determined, it is deleted from the 
data base using the same procedure as that used for the 
deletion of an arciin conjunction with the deletion of a 
node. 
e. Change Arc/Node Information 
The spelling of a node label, the supply at a 
meme, cost for an arc, or an arc's minimum or maximum capac- 
ity can be changed without any index manipulation other than 
that which is required for node or are identification. Once 
mm@erarc or node is identified by the appropriate label 
inputs, a listing of the data to be changed is presented at 
the terminal. The new data is then inserted into the appro- 
priate arrays. 
f. Printing Current Arc/Node Information 
A listing of all current arc and node informa- 
tion can be obtained by the selection of the appropriate 


option. The arc list is obtained by first sequentially 
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Seiecting a node index i. All predecessor are indices are 
meen readily identified as the set H(i), ..-, H(it1)-1. 
Thus the tail node indices corresponding to the arcs are the 
Semeer({H({i)), ..., T{H(it1)-1). The arcs are thea printed at 
the terminal listing the tail and head node labels, cost, 
and minimum and maximum capacities corresponding to the 
Memeoplriate index fie. L(T(H(itn))) TO L{i), C(H(itn)), 
MNCP(H(i+tn)), MXCP(H(itn)) for n = 0, ..., H(it+1)-H(i)-1]. 

The node information is printed at the terminal 
Beeseagquentially listing L(1i) and S$(i) for i= 1, ..., m. 

g. Saving Data File 

If the user desires a permanent file of the data 
artays, they are written to a predefined data file using 
unformatted WRITE statements which allow for minimum stor- 
age. By listing the array lengths first, the data can be 
easily retrieved using READ statements that sequence the 
arrays in the same order as the WRITE statements. The new 
file will write over any previously saved file with the same 
file name, making permanent any changes made to the old 
file, or creating an entirely new file. Appendix A is a 
FORTRAN listing of the write statements used in the systen 


to permit users to recover networks with other programs. 


BS, 





h. Network Checks and Linking GNET 

Two network checks are run prior to the execu- 
mon of GNET. First the supply array S( ) is scanned for 
flags indicating undefined Be ae. When a flag is encoun- 
tered the corresponding node label is printed at the termi- 
nal. Once the entire array has been checked the progran 
returns to the option list to allow the user to formally 
define the listed node. If no undefined nodes are located 
the program continues on to the next check. 

The second check is for orphan nodes, isolated 
nodes with no incident arcs. The head array H( ) is first 
checked for all nodes that have no predecessor arcs (ie. 
H{i) = H(it+1)). The set of node indices that have this 
property are then individually checked against the entire 
tail array T{ ) to determine if there are any successor arcs 
to these nodes; if a node in this set has no successor arcs, 
its label is listed at the terminal. GNET will execute with 
Orphan nodes in the data arrays but the user is given the 
Option of deleting the nodes to "clean-up" the arrays or 
allowing them to remain as reference points for future net- 


work modifications. 
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After both checks are completed the system calls 
GNET as a subroutine to solve the final capacitated network 
flow problen. 
3. Data Input 

All user inputs are read as characters using an 80A1 
mepmat. All leading blanks are ignored. If the first char- 
Meter is a "?", then the program automatically returns to 
the option listing. This allows the user to terminate any 
operation at any time and return to the option list for 
assistance. 

A null response (ie. typing "enter" without typing a 
value) to a request for an integer input results in a zero 
being assigned- for the value. 

For "YES/NO" responses only the first letter is 
read. Any first character response (including a null 
response) other than a "Y" is assumed ta be a "NO" answer. 

For each character string a SOUNDEX code is deter- 
Mined. This is an alpha-numeric code used as a spelling 
error check feg., Ref. 6]. With reasonable accuracy a 
Misspelled word's SOUNDEX code will match the code of the 
correct spelling of the word. When a search of the label 


array L( ) is conducted the SOUNDEX codes are checked as 


Pat | 








af 





well. If the spelling of the newly typed label does not 
exist in the Steavebus there 2S a SOUNDEX code match then a 
possible spelling error is assumed. The user is given the 
options of indicating no spelling error exists at which time 
the label is inserted into the array, or correcting the 
label currently in the data base with the newly typed label, 
or vice versa. 

After the SOUNDEX code has been determined for a 
label, the character string is stored in a two dimensional 
node-length array. Up to twenty characters are saved for 
each label entry. The last four characters are used for the 


SOUNDEX code. 


eee FUTURE ENHANCEMENTS 

Due to the complexity involved in expanding network flow 
probiems to take into consideration more general "real 
world" applications there are no "sasy to use" general 
interactive network generating systems in wide use today. 
For this reason the expansion or enhancement of this systen 
is open to a myriad of possibilities. Por instance: 

1. Expand the data base to create multicommodity net- 


work flow problems [Ref. 1]. 
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Peeecustomize the system for multiperiod problems with 
intermediate inventory at the nodes. 

3. Customize the system so that production levels can 
be optimized at manufacturing nodes as well as flows to 
demand nodes. 

G. Allow for mixed integer programming problems where 


mmere are both fixed and variable costs on the arcs. 
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IIT. USER'S MANUAL 


a a ee eS =e om Ge ame ar oom 


A. INTRODUCTION 

The interactive network generating system is designed to 
create, update, and solve a single-commodity network with 
only a minimal knowledge of network structure and only a 
rudimentary knowledge of computer terminal operation. This 
is accomplished through the interactive use of a set of 
FORTRAN programs which lead the user, step-by-step, through 
the construction of the network by a series of questions and 
then links with GNET, a machine independent FORTRAN program 
for the solution of capacitated network flow problems 
[aet. 3}. 

The entire system has been developed in FORTRAN language 
to allow for portability and possible use with other network 
optimization packages. 

The guestions asked by the system are basically in Eng- 
lish sentence structure and self-explanatory in nature. 

A system of checks have been developed for the program 
that may prevent the user from creating a mathematically 


maconsistent network. 
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Appendix B is a dictionary of network terminology to 
assist the user in understanding the questions asked while 


creating the network. 


eee LNPUT FORMATS 

All numerical inputs into the system must be integer 
values. They are entered one value per line in "free for- 
mat" (a value can be entered anywhere on a line); "right- 
justification" is not necessary. If an alpha character is 
entered where a numeric character is expected, the following 


warning is given: 


\ 
YOU HAVE ENTERED A NONINTEGER WHERE AN INTEGER IS REQUIRED. 


BeeNuPUT THE CORRECT VALUE. 


A null response for a reguest for an integer input is 
assumed to be a zero value. 

A label input will truncate beyond twenty characters. 
All labels must be unique (no two nodes may have the same 
label) or a warning is given as is indicated in the follow- 


ing example: 


NEW YORK HAS ALREADY BEEN DEFINED AS A NODE NAME. Jo DE AG platy 


meeor ANOTHER NAME OR TYPE ? FOR ASSISTANCE. 
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Only a "Y" need be entered for a yes answer to any ques- 
meon creguiring a "YES/NO" response. Any other response 
(including a null response) will be considered as a "NO" 


answer. 


MeeeerNnLTIALIZING THE SYSTEM 
aewestattang the SyStem the User is first presented a 


listing of system requirements followed by the question: 
ARE YOU CREATING A NEW FILE? YES/NO 


A "YES" answer initializes the system and starts the con- 
struction of the network "fron scratch". In this case, the 


user is then asked, 


Met LS THE NAME OF THE COMMODITY PASSING THROUGH THE 
NETWORK? 

>STEEL (">" indicates a keyboard prompt for user.) 

IN WHAT UNITS ARE THE FLOWS AND CAPACITIES MEASURED (IE. 
LBS, TONS, ETC)? 

>TONS 

mmeraat UNETS ARE THE COSTS GIVEN {IE. $/TONS)? 


>$100/TONS 
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The name and unit labels are used in the future questions to 
aid in customizing the system for the individual user. The 
user must keep in mind that once a unit type has been 
defined,-all future capacities, flows, and costs must be 
expressed accordingly. 

A "NO" answer to the new file question results in the 
reading in of previously constructed network data arrays 
from a file that was created and saved during an earlier 
terminal session. This allows the user to create only part 
of the network at a time or change existing network data 
arrays. 

The dimensioning of the data arrays used in the system 


is dynamic, thus the user is asked, 


PeroeULMENSIONS OF THE SYSTEM ARE FOR 1000 ARCS AND 500 
NODES. DO YOU WISH TO CHANGE THEM? YES/NO 

PES 

fom MANY NODES DO YOU WISH TO CREATE? 

>20 

HOW MANY ARCS DO YOU WISH IO CREATE? 

>60 


DATA REGION REQUIRED = 580 AVAILABLE = 12000 


33 





The dimensions once set will prevent the user from increas- 
ing the size of the network beyond the size of the user- 
defined values. Therefore the values should be larger than 
the actual dimensions of the network to be constructed to 
allow for errors or future expansion. When creating a new 


network default dimensioning is 500 nodes and 1000 arcs. 


D. MENU POR CREATING/UPDATING DATA FILE 

Once the system is initialized either as a new network 
or with the parameters of a previously constructed network, 
the user is presented a menu of choices from which to create 
or update the network [{[Fig. 4]. TIyping the corresponding 
line number, the program will present the appropriate series 
of questions to allow the user to accomplish the desired 
action. 

Typing a '?" at any time will return the user to this 
menu, thus allowing for the selection of another option to 


aid in the resolution of a possible problem. 


Creating nodes is the usual starting point for the 
construction of a new network. The questions asked are 
basically self-explanatory. The following is an example of 
Creating the twelfth node ina network with the commodity 


fang STEEL [Fig. 7]: 
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CREATE 


CREATE 


DELETE 


Oe aka ie 


CHANGE 


NODES 

eS 

Peto tenG NODES 
EAUSLOENG ARCS 


CURRENT NODE/SARC INFORMATION WITHOUT CHANGING 


FILE INFORMATION 


Pestle lotenG OF CURRENT FILE INFORMATION 


SAVE A 


SEO 


Figure 4: 


Menu for Creating/Updating Data File 


Bye, 





HOW MANY NODES DO YOU WANT TO CREATE? 

>1 

WHAT IS THE NAME OF NODE NO. 12? 

>MIAMI 

moet OU WANT MIAMI TO BE CREATED LIKE A PREVIOUSLY CREATED 
feos, {LE. ARCS TO AND FROM THE SAME LOCATIONS) ? YES/NO 
>NO 

fame s THE SUPPLY OF STEEL AT MIAMI IN TONS? 

>0 

meets THE DEMAND FOR STEEL AT MIAMT IN TONS? 

>16 

HOW MANY ARCS SHIPPING TO MIAMI DO YOU WANT TO CREATE? 
>1 

meres THE NAME OF THE TALL NODE OF ARC NO. 1 THAT SHIPS TO 
MIAMI? 

D>ATLANTA 

COST PER UNIT IN $100/TON? 

>34 

MeGLMITED CAPACITY? YES/NO 

>NO 

axe CAPACITY IN TONS? 


>16 


36 





fees CAPACITY IN TONS? 


>0 


The questions concerning supply and demand are 
related in such a way that if supply is greater than zero 
the user is not allowed to enter a demand. If supply is 
zero then a demand may be entered. If demand is also zero 
it is assumed that the node is a pure transhippment node. 

A negative supply is interpreted as a demand. A 
negative demand is interpreted as a supply. 

Only arcs shipping to the node being created can be 
constructed at this time. If the tail node has not yet been 
constructed the program will generate a dummy node with the 
same label as entered for the tail node. This dummy node 
must be formally created using the "ADD NODES" option prior 
to completion of the network. description. 

All arcs leading away from the node being created 
are constructed in conjunction with their head node at a 
later time. 

The user is also provided the option of creating a 
node "like" a previously created node (ie. arcs to and fron 
the same locations, same costs, and same capacities) thus 


allowing for a minimal amount of work for the construction 
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of two or more similar nodes. By answering "YES" to the 


previous question the following action is taken: 


mer LS THE NAME OF THE NODE YOU WANT MIAMI TO BE LIKE? 
>AUSTIN 
MEANT NOW HAS THE FOLLOWING STRUCTURE: 


Mem AND; 3 TONS 


Maes: TO FROM $100 7D0N eae. a ae 
MIAMI LOS ANGELES Bat 0 5 
MIANT NEW YORK SHS, 0 12 
MIAMI ATLANTA 49 0 3 
MIAMI CHICAGO 53 0 24 


memcrODTFY ANY OF THE ABOVE DATA RETURN TO THE MENUDO AND 


meoecr THE APPROPRIATE OPTION. 


Arcs can be constructed independent of the creation 
of a node. The same guestions and restrictions are required 
meampeos tho Construction of an arc in conjunction with the 
creation of a node (See previous example). 

3. Delete Existing Nodes 
Deleting a node can cause the greatest change in a 


Hhetwork's structure, thus it is also the most probable 
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Operation to cause an error. All arcs incident to the node 
must be deleted as well. This can isolate other nodes leav- 
ing them completely disjoint from the rest of the network. 
For this reason the program will list the arcs omitted by 
the deletion of a node and allow the user the option to 
moort the operation prior to actual execution. 


The following is an example of deleting a node: 


See LS THE NAME OF THE NODE YOU WANT TO DELETE? 
D>ATLANTA 


DELETING ATLANTA RESULTS IN THE DELETION OF THE FOLLOWING 


ARCS: 
NEW YORK TO ATLANTA 
ATLANTA TO AUSTIN 
ATLANTA TO #AIAMNT 


weer OU STILL WANT TO DELETE THIS NODE? YES/NO 


A "YES" response will cause the deletion of the node as well 

as the deletion of the listed arcs from the data arrays. A 

"NO" response will cause no change to the network to occur. 
4. Delete Existing Arcs 


Since all ares can be identified by their head and 


tail nodes only these labels are required to be entered in 
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order to delete a given arc as is indicated by the following 


example: 


WHAT IS THE NAME OF THE HEAD NODE OF THE ARC YOU ARE 
DELETING? 

>CHICAGO 

WHAT IS THE NAME OF THE TAIL NODE OF THE ARC YOU ARE 
OSLETING? 


>NEW YORK 


5S. Change Current Arc/Node Information 

This option allows the user to change, update, or 
Serrect any element within the data base as long as the 
node-are structure of the network is not altered. Upon 
selecting this option, the user is presented the nenu in 
Figure 5 from which to select the type of change desired. 
After the completion of a change, the program returns to the 
menu OF CHANGES". To return to the "MENU FOR 
CREATING/UPDATING DATA FILE" enter a "?" at any time. 

ae Change/Correct Spelling of Node Label 

To change the spelling of a node label (ie. a 

misspelled label) the user is simply asked what label is to 
be changed and the new spelling as indicated in the follow- 


ing example: 
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CHANGE/CORRECT SPELLING OF NODE LABEL 
CHANGE THE AMOUNT OF SUPPLY OR DEMAND AT A NODE 
CHANGE COST FOR AN ARC 


CHANGE CAPACITY FOR AN ARC 


Figure 5: Menu of Changes 


4 1 





WHICH NODE LABEL DO YOU WANT TO CHANGE? 
>DENVAR 
WHAT IS THE NEW LABEL? 


> DENVER 


b. Change Amount of Supply or Demand 
When changing the amount of supply or demand at 
a node the user must first identify the node. This results 
in the display of a listing of the current supply or demand. 
The user then enters the new value. The following is an 
example of changing a demand node to a pure transhippment 


node: 


WHAT IS THE NAME OF THE NODE POR WHICH YOU WANT TO CHANGE 
SUPPLY OR DEMAND? 

PAUSTIN 

THE DEMAND IS CURRENTLY 8 TONS. 

Siee I5 THE NEW SUPPLY AT THIS NODE? 

>0 

WHAT IS THE NEW DEMAND AT THIS NODE? 


>0 
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Geeciamoe cost £Or an Arc 
When changing the cost for an are the user must 
first identify the arc to be changed. This results in the 
display of a listing of the current cost. The user then 
enters the new value. The following is an example of chang- 


ing the cost on an are: 


WHAT IS THE NAME OF THE HEAD NODE OF THE ARC ON WHICH YOU 
men TO CHANGE COST OR CAPACITY? 
>AUSTIN 
Meeieiso THE NAME OF THE TAIL NODE OF THIS ARC? 
PLOS ANGELES 
SUXRENTLY, COST: 61 $100/TON 
Mine. CAPACIETYs SONS 
HEN. CAPACITY: 0 TONS 
moat IS THE NEW COST? 


>715 


d. Change Capacity of an Arc 
Changing the capacity of an are is done in the 
Same manner as is done for changing the cost for an arc. 


Only the final question changes as follows: 


IS THE NEW MAX. CAPACITY UNLIMITED? YES/NO 


»>NO 
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See tS THE NEW MAX. CAPACITY? 
22e| 
waar iS THE NEW MIN. CAPACITY? 


>0 


Se SE oe eee SS a eS =e SP ees oo — Pp aS ep eee ee SSS oe 


Mais option allows the user to print a listing of 
node and are information currently in the data base. The 
Meer is given the option of printing the listing at the ter- 
minal and/for printer. Figures 6 and 7 are examples of the 
listings for a given network. Figure 8 is a graphical 
representation of the network. 

7. Save a File 

Either at the end of a terminal session or periodi- 
cally during the session the user can save the file just 
completed by selecting option seven. This causes the pro- 
gram to write over any previously saved file thus creating a 
new file or correcting all items that have been changed 
prior to the save option execution. This allows the user to 
Create a permanent file that can be read by the system at a 
later date. Only through the execution of this option will 


any change to the permanent file occur. 
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ARC 


15 


16 


FROM 


NEW YORK 
CHICAGO 

LOS ANGELES 
NEW YORK 
LOS ANGELES 
SALT LAKE CITY 
LOS ANGELES 
OMAHA 

LOS ANGELES 
NEW YORK 
ATLANTA 
CHICAGO 
CHICAGO 
OMAHA 

NEW YORK 


ATLANTA 


EO 


CHICAGO 


OMAHA 


SAtpt BARE City 


ATLANTA 


SEATTLE 


DENVER 


DENVER 


DENVER 


AUSTIN 


AUSTIN 


AUSTIN 


AUSTIN 


MINNEAPOLI 


S) 


MINNEAPOLIS 


WASHINGTON 


MIAMI 


Figure 6; 


Arc Report 
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COoe: 
$100/TON 


34 


74, 


28 


45 


57 


24 


56 


19 


61 


99 


48 


a3 


34 


ot DE Gs & 
TONS 


0 


0 


0 


3 


10 


MAX CAP 
IONS 


11 


6 


10 


15,5) 


21 


12 


24 


Bs 
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NODS NAME one: 
1 LOS ANGELES 34 
ZoeNEw YORK 56 
SCH LeAGO 5 
4 OMAHA 0 
a SALT LAKE GaTy ae) 
6 ATLANTA Se, 
Eee nALL LE =o 
8 DENVER => 
9 AUSTIN =t3) 
10 MINNEAPOLIS =o 
11 WASHINGTON =2' 
12 MIAMI -16 


A NEGATIVE SUPPLY IMPLIES DEMAND 


Figure 7: Node Report 
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8. Run Network Checks and Link GNET 
PRVer tOmtne execution of GNET two checks are fun on 
the network. The first check is to determine whether all 
nodes have been defined using the "CREATE NODES" option. 
All dummy nodes that were created while constructing arcs 


and not subsequently defined are listed as indicated in the 


following example: 


THE FOLLOWING NODES HAVE NOT EXPLICITLY BEEN DEFINED (IE. IT 
HAS NOT BEEN DETERMINED WHETHER THE NODE IS A SOURCE, SINK, 
OR PURE TRANSHIPMENT) : 

MONTEREY 
YOU MUST ADD THE NODES EXPLICITLY TO THE DATA BASE TO ALLOW 


A SOLUTION TO THE NETWORK TO BE FOQOND. 


The user must create these nodes before the program will 
allow execution of GNET. 
If all nodes are defined the user will be informed 


by the following message: 
ALL NODES DEFINED 


The second check is for orphan nodes, isolated nodes 
With no incident arcs. The user is presented with the fol- 


lowing listing: 
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THE FOLLOWING NODE(S) ARE ORPHANS (IE. NO INCIDENT ARCS): 
MIAMI 
GNET WILL WORK WITH THESE NODES LEFT IN THE DATA BASE, BUT 


PoetOU WANT THEM DELETED? YES/NO 


A "YES" response will cause the listed nodes to be perma- 
nently deleted from the data base. The deletion will not 
effect the solution to the network problem. A "NO" response 
will leave the nodes in the data arrays, thus allowing the 
user to add arcs to these nodes at a later date without for- 
mally recreating the nodes. 

Once the checks are successfully completed the pro- 
gram sends the completed network data base to GNET. GNET 
performs some additional checks, such as for improper scal- 
fing of cost coefficients, problem feasibility, etc. For 
more information concerning the internal operation of GNET 
see [Ref. 3]. If all network checks are successful the 
final optimal solution will be listed as in Figures 9 and 
10. 

9. Stop 

The "STOP" option simply terminates the terminal 

session, but prior to the physical termination the user is 


provided one more opportunity to "SAVE A FILE", 
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FROM TO Cosa MIN.CAP FLOW MAX.CAP 


$100/TON TONS CONS TONS 
NEW YORK GHICAGS 34 0 10 11 
CHICAGO OMAHA 23 0 6 6 
LOS ANGELES See GAKE “Ci Ty 28 0 10 10 
NEW YORK ATLANTA 45 5 25 25 
LOS ANGELES SEATTLE 3)f/ Q 18 2 
SALT LAKE CITY DENVER 24 0 5 5 
LOS ANGELES DENVER 56 0 a 7 
OMAHA DENVER 19 0 6 9 
LOS ANGELES AUSTIN 61 0 2 5 
NEW YORK AUSTIN a9 0 0 1) 2 
ATLANTA AGST EN 48 0 0 3 
CHICAGO AUSTIN 53 0 6 24 
CHICAGO MINNEAPOLIS 26 0 5 8 
OMAHA MINNEAPOLIS 20 0 0 2 
NEW YORK WASHINGTON 14 10 2) 23 
ATLANTA MIAMI 34 0 16 16 


COST= 4723. 


Figure 9: Final Solution Arce Report 
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NODE NODE LABEL 


LOS ANGELES 


2 NEW YORK 

3 CHICAGO 

G OMAHA 
Soe LAKE CIEL 
6 ATLANTA 

07 SEAk EPs 

8 DENVER 

9 AUSTIN 

10 MINNEAPOLIS 
11 WASHINGTON 
12 MIAMI 
Figure 10: 
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Final Solution Node Report 





E. ADDITIONAL SYSTEM CHECKS AND SAFEGUARDS 


A new label is always checked with existing labels 
already in the data base prior to its insertion in the data 
base. A spelling error check is made by the comparison of a 
coded form of the labels [Ref. 6]. If the codes match but 
the exact spelling of the labels do not, a possible spelling 
error is assumed and the user is given the option to correct 
the error. This helps prevent the creation of two nodes, 
due to a spelling error, when the user intends only one. 

The following is presented to the user to correct the proba- 


ble error: 


YOU HAVE A POSSIBLE SPELLING ERROR. TYPE THE CORRESPONDING 
Dene NUMBER FOR THE APPROPRIATE ACTION. 

fee NO SPELLING ERROR G@XISTS 

Zee MISSPELLED: CHICEGO CORRBGL wWwlLTH: CHICAGO 


3. MESSPELLEDs CHICAGO CORRECT WLiTHs CHICEGO 


A response of "1" will cause no change to occur and the pro- 
gram will continue. A response of "2" or "3" will cause the 


first label to be replaced by the second permanently. 
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Tf the minimum capacity is greater than the maxinun 


for a given are the following warning is displayed: 


MoOUNGAVE A MIN. CAPACITY GREATER THAN THE CORRESPONDING MAX. 


PROVIDE THE CORRECT VALUES. 


Simply provide the correct values in the proper order when 
prompted for the new maximum and minimum capacities. 
3. Multiple Ares 
Both the network generating system amd GNET will 
admit multiple arcs. When the system is required to iden- 
tify a specific multiple arc the user must identify the 
Correct arc by its corresponding sost or capacity as is 


indicated in the following example: 


THERE ARE MULTIPLE ARCS BETWEEN THE NODES NEW YORK AND 
CHICAGO. TYPE THE CORRESPONDING LINE NUMBER OF THE ARC YOU 
WANT DELETED. 

ieeecOoat: 34 STOO/TON, MAX.CAP.: 11 TONS, MIN.CAP.: 0 TONS 


Bemeeesit: 25 SIQ00/TON, MAX.CAP.: 7 TONS, MIN.CAP.: 0 TONS 
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REWIND O09 
WRITE(9) N, M, IDIM1, I 
eset) ea les) Ne 
Ree © ah (Be) J3=1, N) 
1 (EXP 35) ,35=1,N) {ANC 
RITE 2) pe J8=1, M) 
WRITE(9) ((1(916,511) ,J 
Number of arcs: 
Number of nodes: 
Commodity label: 
Capacity units label: 
Cost units label: 
Tail nodes: 
Costs; 
Maximum capacities: 
Minimum capacities: 
Maximum ~- Minimum capacities: 


Head node entries into T( ): 
Supplies: 


Node labels: 
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CAPLAB 


CSTLAB 


A 
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APPENDIX 8 


Arc A vector, a unidirectional means of indicating commod- 


mor, transportation among locations, or routes. 


Alpha Character Any letter in the English alphabet (ie. 


A, lo cre eeee g fp 


Sooemeer Unit The cost of Shipping one unit of a coumodity 


across a given arc. 


Dual Variable A price associated with a constraint of the 
Original (primal) problem (ie. marginal cost or shadow 


price). 


Head Node An incident node at the end of an arc to which 


the arc flow is noving. 


Integer Whole number. 


Max. Capacity/Upper Bound The maximum amount of a commodity 


that can flow across a given arc. 


Min. Capacity/Lower Bound The minimum amount of a commodity 


that can flow across a given arc. 


Multiple Arcs More than one arc between the same two nodes 


with their flow orientation in the same direction. 
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Node A location or terminal connected by arcs and served 
by whatever physical means of transportation is 


associated with the arcs. 
Mmipemerecn character A Single digit (ie. 0, 1, «+, 9). 
Orphan Node An isolated node with no incident arcs. 


Predecessor Arc For a given node an are with its head at 


that node. 


Prompt Indicated in this text as ">", the prompt character 
indicates that a user-supplied input is required before 


further execution. 
Sink Node A node with demand. 
Source Node A node with supply. 


Successor Arc For a given node an arc with its tail at 


f 


that node. 


Transhippment Node A node with zero supply and zero 


demand. 
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